還原系統配置

本程序用於在下列狀況下回復系統配置：僅當回復系統程序失敗，或者當不需要磁區上所儲存的資料時。

開始之前

這個配置還原程序主要用於還原配置的相關資訊，例如磁區、儲存區及節點。不會還原已寫入磁區的資料。如果要還原磁區上的資料，您必須另外從任何以叢集系統上的磁區作為儲存體的應用程式中，還原應用程式資料。因此，在您遵循配置回復程序之前，必須具有此資料的備份。

在 T4 回復期間會以新的憑證建立新系統。如果系統具有金鑰伺服器加密，您必須使用 chsystemcert -export 指令來匯出新憑證，然後安裝在所有金鑰伺服器的正確裝置群組中，才能執行 T4 回復。使用的裝置群組是定義先前系統的裝置群組。可能還需要簽署新系統的憑證。在 T4 回復過程中，讓金鑰伺服器管理者知道現行金鑰不安全。

如果在備份系統配置時在該系統上啟用了使用 Gemalto SafeNet KeySecure 加密金鑰伺服器，並且設定了使用者名稱和密碼，則在執行配置還原指令之前，需要配置該使用者名稱和密碼。

重要：執行 T4 程序之前，請聯絡 IBM 支援中心以取得協助。

關於這項作業

您必須定期備份配置資料和應用程式資料，以避免資料流失。如果系統在發生嚴重故障之後停止運作，系統配置和應用程式資料都會遺失。您必須將系統還原到故障之前的確切狀態，然後回復應用程式資料。

在還原過程中，節點和儲存體機箱會還原到系統，然後會重新建立並配置 MDisk 和陣列。如果涉及多個儲存體機箱，則會根據機箱 ID，在適當的機箱上還原陣列和 MDisk。

重要：

還原過程有兩個階段：準備和執行。在這兩個階段之間不得變更光纖或系統。
對於 VMware vSphere 虛擬磁區（有時稱為 VVOL）環境而言，在進行 T4 還原之後，部分虛擬磁區配置步驟已經完成；這時已建立 metadatavdisk，已建立 user group 和使用者，已建立 adminlun 主機。不過，使用者必須接著手動完成最後兩個配置步驟（在 IBM Spectrum® Connect 上建立一個儲存器，在 VMware vCenter 上建立虛擬機器）。請參閱配置虛擬磁區。

如果不瞭解 CLI 指令的執行指示，請參閱指令行介面參照資訊。

如果要還原配置資料，請遵循下列步驟：

程序

在執行此回復程序前，驗證是否所有節點都可作為候選節點。必須移除錯誤 550 或 578，才能讓節點變成候選狀態。
使用下列指令來建立系統。可能的話，請使用原先位於 I/O 群組 0 中的節點。
```
satask mkcluster -clusterip system_IP -gw gw -mask mask
```
在支援的瀏覽器中，輸入您用於起始設定系統的 IP 位址及預設超級使用者密碼 (passw0rd)。

重要：請檢查是否已建立預設 Call Home 電子郵件使用者。如果已建立，請刪除預設 Call Home 電子郵件使用者。為了讓 T4 系統回復順利進行，目前請不要配置 Call Home。

發出下列 CLI 指令以確保只有配置節點在線上：

svcinfo lsnode

顯示的輸出範例如下：

id name status IO_group_id IO_group_name config_node
1 nodel online 0 io_grp0 yes

使用指令行介面，發出下列指令以登入系統：
```
plink -i ssh_private_key_file superuser@cluster_ip
```
其中，ssh_private_key_file 是超級使用者的 SSH 私密金鑰檔名稱，cluster_ip 是要還原配置之系統的 IP 位址或 DNS 名稱。

註：由於 RSA 主機金鑰已變更，因此使用 SSH 連接至系統時，可能會顯示警告訊息。
識別您要還原的配置備份檔。

該檔案可以是您備份配置時所儲存之配置備份 XML 檔案的本端副本，也可以是其中一個節點上的最新檔案。

配置節點會在每天系統時間 01:00 自動備份配置資料。

下載並檢查先前系統中所有節點上的配置備份檔，確定包含最新完整備份的檔案。
1. 從管理 GUI，按一下設定 > 支援 > 支援套件。
2. 展開手動上傳指示，然後選取下載支援套件。
3. 在下載新的支援套件或日誌檔頁面上，選取下載現有的套件。
4. 對於系統中的每個節點（機匣），請完成下列步驟：
  1. 從表格頂端的選取框中，選取要處理的節點。
  2. 尋找名稱符合 svc.config.*.xml* 型樣的所有檔案。
  3. 選取檔案，然後按下載以下載到電腦。
XML 檔案包含日期和時間，可用來識別最新備份。在識別要於還原系統的備份 XML 檔案後，請將檔案重新命名為 svc.config.backup.xml。

將您要據以還原的 XML 備份檔複製到系統。

pscp full_path_to_identified_svc.config.file 
superuser@cluster_ip:/tmp/svc.config.backup.xml

如果系統包含任何 iSCSI 儲存體控制器，現在必須手動偵測這些控制器。在還原資料之前，必須先將連接至這些控制器的節點、iSCSI 埠 IP 位址及 iSCSI 儲存體埠新增至系統。
1. 如果要新增這些節點，請從配置備份檔中決定任何這種節點的畫面名稱、節點名稱和 I/O 群組。如果要將這些節點新增至系統，請執行下列指令：
```
svctask addnode -panelname panel_name -iogrp iogrp_name_or_id -name node_name
```
  其中，panel_name 是畫面上顯示的名稱，iogrp_name_or_id 是要其中新增此節點之 I/O 群組的名稱或 ID，node_name 是節點的名稱。
2. 如果要還原 iSCSI 埠 IP 位址，請使用 cfgportip 指令。
  1. 如果要還原 IPv4 位址，請從配置備份檔中決定 id (port_id)、node_id、node_name、IP_address、mask、gateway、host（0/1 表示 no/yes）、remote_copy（0/1 表示 no/yes）及 storage（0/1 表示 no/yes），然後執行下列指令：
```
svctask cfgportip -node node_name_or_id -ip ipv4_address -gw ipv4_gw 
-host yes | no -remotecopy remote_copy_port_group_id -storage yes | no -hpgid
host_port_grp_id port_id
```
    其中，node_name_or_id 是節點的名稱或 ID，ipv4_address 是埠的 IPv4 版本通訊協定位址，ipv4_gw 是埠的 IPv4 閘道位址。
  2. 如果要還原 IPv6 位址，請從配置備份檔中決定 id (port_id)、node_id、node_name、IP_address_6、mask、gateway_6、prefix_6、host_6（0/1 表示 no/yes）、remote_copy_6（0/1 表示 no/yes）及 storage_6（0/1 表示 no/yes），然後執行下列指令：
```
svctask cfgportip -node node_name_or_id -ip_6 ipv6_address -gw_6 ipv6_gw 
-prefix_6 prefix -host_6 yes | no -remotecopy_6 remote_copy_port_group_id -storage_6 yes | no
-hpgid host_port_grp_id port_id
```
    其中，node_name_or_id 是節點的名稱或 ID，ipv6_address 是埠的 IPv6 版本通訊協定位址，ipv6_gw 是埠的 IPv6 閘道位址，prefix 是 IPv6 字首。
    
    註：參數 -hpgid 專門用於手動 T4 回復。請不要在其他場景下使用此參數。
  針對備份配置檔的 node_ethernet_portip_ip 區段中的所有（先前已配置的）IP 埠，完成步驟 b.i 和 b.ii。
3. 手動將雲端儲存體新增至系統。
  如果要手動將雲端儲存體新增至系統，請完成下列步驟：
  1. 如果要配置用於向 IBM Cloud™ 後端儲存體鑑別的 iSCSI 起始器資訊，請輸入下列指令：
```
svctask chiscsiportauth -src_ip ip_address -iqn iqn -username username -chapsecret chapsecret 
```
    或
```
svctask chiscsiportauth -src_port_id port_id -node node_id | node_name -iqn iqn -username username -chapsecret chapsecret
```
  2. 如果要驗證 iSCSI 起始器配置，請輸入下列指令：
```
svcinfo lsiscsiportauth
```
  3. 如果要偵測雲端儲存體，請輸入下列指令：
```
svctask detectiscsistorageportcandidate -srcportid source_port_id -targetip target_ip
```
    為以下參數輸入下列內容：
    
    source_port_id
    
    輸入系統中第一個節點的來源埠 ID。
    
    target_ip
    
    輸入雲端儲存體 IP 位址。此資訊可從 IBM Cloud 儲存體入口網站取得。
    
    username
    
    輸入與「盤查信號交換驗證通訊協定 (CHAP) 」密碼相關聯的使用者名稱。
    
    password
    
    輸入與系統的 CHAP 使用者名稱相關聯的密碼。
    
    node_id or node_name
    
    輸入系統中第一個節點的節點 ID 或名稱。對於 IBM Cloud 儲存體，您必須指定 -node 參數。因為 IBM Cloud 環境支援起始器節點特定的鑑別，所以單一使用者名稱及 CHAP 密碼不足以探索目標埠。
  4. 如果要列出雲端儲存體上的目標埠，請輸入下列指令：
```
svcinfo lsiscsistorageportcandidate
```
  5. 如果要將儲存體埠定義為節點的目標埠，請輸入下列指令：
```
svctask addiscsistorageport candidate_id
```
    candidate_id
    
    輸入要新增至節點之候選埠的 ID。此值會顯示在 lsiscsistorageportcandidate 指令的結果中。
  6. 如果要識別儲存體埠，請輸入下列指令：
```
svcinfo lsiscsistorageport
```
    請確定您已記錄指令結果中的 -rowid 值。此值指示透過目標 IP 位址所建立，從指定的起始器節點埠至雲端儲存體的目標 iSCSI 完整名稱 (IQN) 的階段作業。
發出下列 CLI 指令，以比較現行配置與備份配置資料檔：
```
svcconfig restore -prepare
```
這個 CLI 指令會在配置節點的 /tmp 目錄中建立日誌檔。日誌檔的名稱為 svc.config.restore.prepare.log。
註：探索每一個 256-MDisk 批次需要將近一分鐘的時間。輸入這個指令之後，如果 MDisk 出現 CMMVC6200W 錯誤訊息，表示可能尚未探索到所有受管理磁碟 (MDisk)。請稍待片刻再重試 svcconfig restore -prepare 指令。
如果系統具有金鑰伺服器加密，您必須使用 chsystemcert -export 指令來匯出新憑證，然後安裝在所有金鑰伺服器的正確裝置群組中，才能執行 T4 回復。使用的裝置群組是定義先前系統的裝置群組。可能還需要簽署新系統的憑證。

發出下列指令，將日誌檔複製到系統可存取的其他伺服器：

pscp superuser@cluster_ip:/tmp/svc.config.restore.prepare.log 
full_path_for_where_to_copy_log_files

從目前儲存副本的伺服器中開啟該日誌檔。
檢查日誌檔中是否有錯誤。
- 如果發現錯誤，請更正導致錯誤的情況，然後重新發出指令。必須更正所有錯誤，才能繼續步驟 14。
- 如果需要協助，請聯絡支援中心。
發出下列 CLI 指令以還原配置：
```
svcconfig restore -execute
```
註：還原過程中會自動新增您未手動新增至系統的任何節點。

這個 CLI 指令會在配置節點的 /tmp 目錄中建立日誌檔。日誌檔的名稱為 svc.config.restore.execute.log。

發出下列指令，將日誌檔複製到系統可存取的其他伺服器：

pscp superuser@cluster_ip:/tmp/svc.config.restore.execute.log 
full_path_for_where_to_copy_log_files

從目前儲存副本的伺服器中開啟該日誌檔。
檢查日誌檔，確保沒有出現任何錯誤或警告。
註：您可能會收到警告，指出授權特性未啟用。此訊息表示在回復程序之後，現行授權設定與先前授權設定不符。回復程序會繼續正常執行，您稍後可以在管理 GUI 中輸入正確的授權設定。

再次透過 SSH 登入 CLI 時，您會看到下列輸出：
```
IBM_2145:your_cluster_name:superuser>
```

下一步

您可以發出下列 CLI 指令，從配置上的 /tmp 目錄中移除任何不想要的配置備份及還原檔案。

svcconfig clear -all

還原系統之後，必須重新配置 IP 仲裁。